package com.skiving.cloud.admin.controller;

import com.mybatisflex.core.paginate.Page;
import com.skiving.cloud.common.utils.PageParameter;
import com.skiving.cloud.common.utils.ReturnT;
import com.skiving.cloud.common.utils.UuidUtil;
import org.noear.solon.annotation.*;
import org.noear.solon.core.util.MimeType;
import com.skiving.cloud.admin.entity.SysMenuClickTop;
import com.skiving.cloud.admin.service.SysMenuClickTopService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;

import java.util.List;

/**
 * 用户点击率排名前5的菜单，每天会通过定时任务更新 控制层。
 *
 * @author skivingcloud
 * @since 2025-03-08
 */
@Controller
@Api("用户点击率排名前5的菜单，每天会通过定时任务更新接口")
@Mapping("/sysMenuClickTop")
@Produces(MimeType.APPLICATION_JSON_UTF8_VALUE)
public class SysMenuClickTopController {

    @Inject
    private SysMenuClickTopService sysMenuClickTopService;

    /**
     * 添加用户点击率排名前5的菜单，每天会通过定时任务更新。
     *
     * @param sysMenuClickTop 用户点击率排名前5的菜单，每天会通过定时任务更新
     * @return {@code true} 添加成功，{@code false} 添加失败
     */
    @Post
    @Mapping("/save")
    @ApiOperation("保存用户点击率排名前5的菜单，每天会通过定时任务更新")
    public ReturnT<Boolean> save(@Body @ApiParam("用户点击率排名前5的菜单，每天会通过定时任务更新") SysMenuClickTop sysMenuClickTop) {
        sysMenuClickTop.setId(UuidUtil.get32UUID());
        return ReturnT.ok(sysMenuClickTopService.save(sysMenuClickTop));
    }

    /**
     * 根据主键删除用户点击率排名前5的菜单，每天会通过定时任务更新。
     *
     * @param id 主键
     * @return {@code true} 删除成功，{@code false} 删除失败
     */
    @Get
    @Mapping("/remove/{id}")
    @ApiOperation("根据主键用户点击率排名前5的菜单，每天会通过定时任务更新")
    public ReturnT<Boolean> remove(@Path @ApiParam("用户点击率排名前5的菜单，每天会通过定时任务更新主键") String id) {
        return ReturnT.ok(sysMenuClickTopService.removeById(id));
    }

    /**
     * 根据主键更新用户点击率排名前5的菜单，每天会通过定时任务更新。
     *
     * @param sysMenuClickTop 用户点击率排名前5的菜单，每天会通过定时任务更新
     * @return {@code true} 更新成功，{@code false} 更新失败
     */
    @Post
    @Mapping("/update")
    @ApiOperation("根据主键更新用户点击率排名前5的菜单，每天会通过定时任务更新")
    public ReturnT<Boolean> update(@Body @ApiParam("用户点击率排名前5的菜单，每天会通过定时任务更新主键") SysMenuClickTop sysMenuClickTop) {
        return ReturnT.ok(sysMenuClickTopService.updateById(sysMenuClickTop));
    }

    /**
     * 查询所有用户点击率排名前5的菜单，每天会通过定时任务更新。
     *
     * @return 所有数据
     */
    @Get
    @Mapping("/list")
    @ApiOperation("查询所有用户点击率排名前5的菜单，每天会通过定时任务更新")
    public ReturnT<List<SysMenuClickTop>> list() {
        return ReturnT.ok(sysMenuClickTopService.list());
    }

    /**
     * 根据用户点击率排名前5的菜单，每天会通过定时任务更新主键获取详细信息。
     *
     * @param id 用户点击率排名前5的菜单，每天会通过定时任务更新主键
     * @return 用户点击率排名前5的菜单，每天会通过定时任务更新详情
     */
    @Get
    @Mapping("/getInfo/{id}")
    @ApiOperation("根据主键获取用户点击率排名前5的菜单，每天会通过定时任务更新")
    public ReturnT<SysMenuClickTop> getInfo(@Path @ApiParam("用户点击率排名前5的菜单，每天会通过定时任务更新主键") String id) {
        return ReturnT.ok(sysMenuClickTopService.getById(id));
    }

    /**
     * 分页查询用户点击率排名前5的菜单，每天会通过定时任务更新。
     *
     * @param parameter 分页对象
     * @return 分页对象
     */
    @Post
    @Mapping("/page")
    @ApiOperation("分页查询用户点击率排名前5的菜单，每天会通过定时任务更新")
    public ReturnT<Page<SysMenuClickTop>> page(@Body @ApiParam("分页信息") PageParameter<SysMenuClickTop> parameter) {
        return ReturnT.ok(sysMenuClickTopService.queryByPage(parameter));
    }

}
